設置 MCS 和 PCS 之間的笛卡爾變換。
語法
KsCommandStatus SetCartesianTransform(
int Index,
double TransX,
double TransY,
double TransZ,
double RotAngle1,
double RotAngle2,
double RotAngle3,
McExecutionMode ExecutionMode
);參數
Index [in]：軸組索引，索引以零為起點。最多可有 32 個軸組。
TransX [in]：平移向量的 X 軸分量。
TransY [in]：平移向量的 Y 軸分量。
TransZ [in]：平移向量的 Z 軸分量。
RotAngle1 [in]：Z 軸旋轉角度分量，單位：度。
RotAngle2 [in]：Y 軸旋轉角度分量，單位：度。
RotAngle3 [in]：X 軸旋轉角度分量，單位：度。
ExecutionMode [in]：定義函式的時間順序，請見 McExecutionMode 類型。
備註
- KINGSTAR 先旋轉後移動變換向量。
- 取消選擇 PCS 可以透過執行此函式與 {TransX, TransY, TransZ, RotAngle1, RotAngle2, RotAngle3} = {0, 0, 0, 0, 0, 0} 作為平移與旋轉輸入值來完成。
- 系統可能支援中性變換，中性變換啟動後，MCS 系統將再次引用軸。
- 在同一組軸上可以同時套用多個笛卡爾變換。
平移的定義：
旋轉定義之範例：
旋轉是透過繞著每個以 Z 方向開始的座標方向進行後續旋轉來定義的。
旋轉的定義：
範例：平面內的旋轉（二維）
SetCartesianTransform 使用 { 50, 50, 0, 0, 0, 30 }：
回傳值
返回 KsCommandStatus 結構。
範例
N/A使用需求
| RT | Win32 | |
|---|---|---|
| 最低支援版本 | 4.1 | 4.1 |
| 標頭檔 | ksmotion.h | ksmotion.h |
| 程式庫 | KsApi_Rtss.lib | KsApi.lib |
參見